<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>修改 Oracle 用户的密码</title>
 </head>
 <body class="docs"><div id="layout">
  <div id="layout-content"><div id="function.oci-password-change" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">oci_password_change</h1>
  <p class="verinfo">(PHP 5, PHP 7, PECL OCI8 &gt;= 1.1.0)</p><p class="refpurpose"><span class="refname">oci_password_change</span> &mdash; <span class="dc-title">修改 Oracle 用户的密码</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.oci-password-change-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>oci_password_change</strong></span>
    ( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$connection</code></span>
   , <span class="methodparam"><span class="type">string</span> <code class="parameter">$username</code></span>
   , <span class="methodparam"><span class="type">string</span> <code class="parameter">$old_password</code></span>
   , <span class="methodparam"><span class="type">string</span> <code class="parameter">$new_password</code></span>
   ) : <span class="type">bool</span></div>

  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>oci_password_change</strong></span>
    ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$dbname</code></span>
   , <span class="methodparam"><span class="type">string</span> <code class="parameter">$username</code></span>
   , <span class="methodparam"><span class="type">string</span> <code class="parameter">$old_password</code></span>
   , <span class="methodparam"><span class="type">string</span> <code class="parameter">$new_password</code></span>
   ) : <span class="type">resource</span></div>

  <p class="para rdfs-comment">
   修改用户 <code class="parameter">username</code>
   的密码。<code class="parameter">old_password</code> 和
   <code class="parameter">new_password</code> 应分别指定旧密码和新密码。
  </p>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <span class="simpara">
    第二种 <span class="function"><strong>oci_password_change()</strong></span> 的语法自版本
    1.1（OCI8 扩展库版本）起可用。
   </span>
  </p></blockquote>
  <p class="para">
   成功时返回 <strong><code>TRUE</code></strong>， 或者在失败时返回 <strong><code>FALSE</code></strong>。
  </p>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    在 PHP 5.0.0 之前的版本必须使用 <span class="function"><strong>ocipasswordchange()</strong></span>
    替代本函数。该函数名仍然可用，为向下兼容作为
    <span class="function"><strong>oci_password_change()</strong></span> 的别名。不过其已被废弃，不推荐使用。
   </p>
  </p></blockquote>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.oci-password-change-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>

    
     <dt>
<code class="parameter">connection</code></dt>

     <dd>

      <p class="para">
       An Oracle connection identifier, returned by 
       <span class="function"><a href="oci_connect.html" class="function">oci_connect()</a></span> or <span class="function"><a href="oci_pconnect.html" class="function">oci_pconnect()</a></span>.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">username</code></dt>

     <dd>

      <p class="para">
       The Oracle user name.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">old_password</code></dt>

     <dd>

      <p class="para">
       The old password.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">new_password</code></dt>

     <dd>

      <p class="para">
       The new password to be set.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">dbname</code></dt>

     <dd>

      <p class="para">
       The database name.
      </p>
     </dd>

    
   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.oci-password-change-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   成功时返回 <strong><code>TRUE</code></strong>， 或者在失败时返回 <strong><code>FALSE</code></strong>。
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.oci-password-change-notes">
  <h3 class="title">注释</h3>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    Changing the password either with this function or directly in
    Oracle should be done carefully.  This is because PHP applications
    may continue to successfully reuse persistent connections by
    authenticating with the old password.  The best practice is to
    restart all web servers whenever the user password is changed.
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    If upgrading the Oracle client libraries or the database from a release prior to 11.2.0.3
    to version 11.2.0.3 or higher, <span class="function"><strong>oci_password_change()</strong></span> may give the
    error &quot;ORA-1017: invalid username/password&quot; unless both client and server versions are upgraded at
    the same time.
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <span class="simpara">
    The second <span class="function"><strong>oci_password_change()</strong></span> syntax is available
    since OCI8 version 1.1.
   </span>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    In PHP versions before 5.0.0 you must use <span class="function"><strong>ocipasswordchange()</strong></span> instead.
    This name still can be used, it was left as alias of
    <span class="function"><strong>oci_password_change()</strong></span> for downwards compatability.
    This, however, is deprecated and not recommended.
   </p>
  </p></blockquote>

 </div>

</div></div></div></body></html>